'\" t
.\"     Title: bugle-extoverride
.\"    Author: 
.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
.\"      Date: October 2007
.\"    Manual: Bugle user manual
.\"    Source: BUGLE 0.0.20150628
.\"  Language: English
.\"
.TH "BUGLE\-EXTOVERRIDE" "7" "October 2007" "BUGLE 0.0.20150628" "Bugle user manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
bugle-extoverride \- hide OpenGL extensions from an application
.SH "SYNOPSIS"
.sp
.nf
filterset extoverride
{
    version "1\&.5"
    disable "all"
    disable "\fIextension\fR"
    enable "\fIextension\fR"
}
.fi
.SH "DESCRIPTION"
.PP
The
extoverride
filter\-set modifies the version and extension strings to hide driver capabilities from the application\&. The primary use is to test an application to ensure that it works correctly on drivers that do not offer these capabilities\&.
.PP
Apart from modifying these strings, a warning is printed to the log if any function from one of these extensions is called\&.
.SH "OPTIONS"
.PP
\fBversion\fR
.RS 4
Sets a new value for
GL_VERSION\&. However, if the true value is lexicographically smaller than this value, the true value is used\&.
.RE
.PP
\fBdisable\fR "all"
.RS 4
By default, extensions are exposed unless explicitly disabled\&. This option reverses the behaviour to hide all extensions that are not explicitly enabled\&.
.RE
.PP
\fBdisable\fR "\fIextension\fR"
.RS 4
Hides the named extension from the application\&. A warning is printed if the extension was not known at the time
bugle
was compiled; in this case it will still be hidden, but there will not be any warning if it is used anyway\&.
.RE
.PP
\fBenable\fR "\fIextension\fR"
.RS 4
Like the
\fBdisable\fR
option, but enables an extension when the default is disabled\&.
.RE
.SH "BUGS"
.PP
Warnings are only printed if
\fIfunctions\fR
from the disabled extensions are called\&. At present, no warning will be printed if tokens from those extensions are passed (which is difficult to determine, since multiple tokens may share the same numeric value)\&. Furthermore, some extensions alter semantics without explicit functions or tokens, such as
GL_ARB_texture_non_power_of_two; no warnings are issued if these extensions are used\&.
.PP
Also note that extension loader libraries may interfere with the warning mechanism\&. For example,
GLee
uses wrappers that cause illegal function calls to be silently ignored\&.
.SH "AUTHOR"
.PP
bugle
is written and maintained by
Bruce Merry\&.
.SH "SEE ALSO"
.PP
\fBbugle\fR(3),
\fBbugle-log\fR(7),
\fBbugle-showextensions\fR(7)
